home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / qwrite12.zip / QWRITE.DOC next >
Text File  |  1989-01-12  |  12KB  |  236 lines

  1.                                   QWRITE V1.2
  2.                     The Questionaire Writer for RBBS Sysops
  3.                ------------------------------------------------
  4.  
  5. QWRITE is intended to be an aid to RBBS Sysops in writing questionaires.    It 
  6. tries  to reduce the hassle of writing a questionaire down to writing out  the 
  7. text and letting QWRITE setup the logic and formatting. 
  8.  
  9. Some  limited  editing functions are incorporated into the program but not  to 
  10. the  extent that it would duplicate what a word processor will do.   Prompting 
  11. is given at the bottom of the screen so that it is known what to do at a given 
  12. part of the program without having to guess.   Full color control is available 
  13. so that you can choose your own colors during the course of the program. 
  14.  
  15. One  exciting  feature  of  QWRITE  is  that  it  creates  a  profile  of  the 
  16. questionaire  as  it  is  being written.   This is intended to be  used  by  a 
  17. companion  program that will hopefully be out this fall under the name  QREAD. 
  18. This  will  assist  the program in reading the questionaire and  know  how  to 
  19. interpret  each question.   A  brief outline will be given at the end of  this 
  20. documentation of the layout of the file. 
  21.  
  22. The  multiple choice question answer comparison line will go to the next  line 
  23. on  all answers.   The next version of QWRITE will possibly have the option to 
  24. jump to different questions based on the answers.   You still have the ability 
  25. to  edit  the  comparison  line from within QWRITE so long as  the  number  of 
  26. answers to not go beyond 5.  After that you will have to edit the questionaire 
  27. using your favorite word processor. 
  28.  
  29. This program was developed on a pc compatible with a color display.   With the 
  30. option being given to change your colors, this will hopefully help those users 
  31. with monochrome screens.  I have no way of testing the program in this type of 
  32. environment,   so  I will help as best I can.   This program  will  run  under 
  33. Desqview.   
  34.  
  35. If you are upgrading to V1.1, you will need to reconfigure the program because 
  36. of a change in the parameter file.  Save a copy of your present QWRITE.PRM 
  37. file so that it can help you upgrade to the new version.
  38.  
  39. Main Menu -
  40. -----------
  41.  
  42. Create  -  this  option puts you into a another menu that will assist  in  the 
  43. creation of a questionaire. 
  44.  
  45. Delete - lets you delete a questionaire that you no longer need.  This deletes 
  46. only the questionaire but leaves the profile and answer file intact. 
  47.  
  48. Display  - a browse like function that lets you look at the questionaire in  a 
  49. non-desctructive manner. 
  50.  
  51. Edit  - lets you do some MINOR editing of a questionaire.   Will not  let  you 
  52. edit a line that is longer that can be displayed on the screen. 
  53.  
  54. Print  -  will  print out a questionaire to the designated printer  device  as 
  55. specified in the configuration file. 
  56.  
  57. Configuration  -  this  is  where you get to change the  colors  used  by  the 
  58. program,  the extension of the answer file,  the drive and path to the  files, 
  59. and  the type of printer being used.   The program defaults to LPT1:,  to  use 
  60. others  -  please consult your DOS manual (especially in the case of a  serial 
  61. printer. 
  62.  
  63. Quit -exits out of the program.
  64.  
  65.                     --------------------------------------
  66.                          Construct Questionaire Option
  67.                      ------------------------------------
  68.  
  69. This  is  where you get to build the questionaire to use with  RBBS.    Naming 
  70. conventions  and  the  logic used in the comparisons is as  specified  in  the 
  71. Sysops manual for RBBS.  The number comparison is not directly supported as an 
  72. option, although you could edit that in very easily.   The abort question puts 
  73. in  a predeterined text prompt of "Have you answered this questionaire before ?
  74. This too can be edited with the edit feature of QWRITE.   In  a future version 
  75. of this program, hopfully this will be an option as well. 
  76.  
  77. Opening Statement -
  78. -------------------
  79.  
  80.         After  selecting this option,  you are presented with a  miniature  10 
  81. line word processor type environment.  There is some limited editing available 
  82. here  but not a lot.   To leave this option,  just press Return (Enter)  on  a 
  83. blank line. 
  84.  
  85. Abort Question -
  86. ----------------
  87.  
  88.         This  option require no operator input.   If you do not like the  text 
  89. used by  the question,  edit it to your liking or use the edit option built in 
  90. to QWRITE.  In a future release of the program, this may be an option. 
  91.  
  92. Simple Question -
  93. -----------------
  94.  
  95.         The  option is given here to have a line of text preceding the  actual 
  96. question.    I   have  seen  several questionaire  where  the  user  is  given 
  97. suggestions as to the formatting of the answer.   This could be used here  for 
  98. that or for further explanation. 
  99.  
  100. Yes/No Question -
  101. -----------------
  102.  
  103.         This  is  the  simple question with a (Y/N)  tacked on to  end  and  a 
  104. comparison line below the text of the question. 
  105.  
  106. Multiple Choice -
  107. -----------------
  108.  
  109.         First  you  are  presented  with  a  10   line  window  to  setup  the 
  110. introduction  and lead statement to the multiple choice question.   The number 
  111. of answers is next asked for and then the possible answers one by one. 
  112.  
  113. Numeric Question -
  114. ------------------
  115.  
  116.         This  is  a handy option for use in questionaires where you  with  the 
  117. user  to  attach a preference to a particular question  or  statement.    This 
  118. question traps for number 0 - 9 and rejects any other input. 
  119.  
  120. Closing Statement -
  121. -------------------
  122.  
  123.         This is basically a variation of the opening statement except that  it 
  124. will bring to a close the creation of a questionaire. 
  125.  
  126. Quit -
  127. ------
  128.  
  129.         Closes the creation of the Questionaire script file and profile.
  130.  
  131. -------------------------
  132. Questionaire Profile file
  133. -------------------------
  134.  
  135. I  wont go into a lot of explanation here but to say that this file is created 
  136. for  each questionaire to assist with the analysis of answers by  a  companion 
  137. program that I hope to release this fall called QREAD.  Contained in this file 
  138. is the name of the answer file,  question number and type and in the case of a 
  139. multiple choice question, the number of answers. 
  140.  
  141. HISTORY OF QWRITE -
  142. -------------------
  143.  
  144. 1.0  -  Initially released on June 3, 1988.   Hoped to be an easier way to use 
  145. the questionaire function of RBBS. 
  146.  
  147. 1.1  -  Adds the ability to edit the Abort Question text and adds the  Numeric 
  148. Question.  Released July 24, 1988. 
  149.  
  150. 1.2  -  Included on-line context sensitive help screens. Released January 1989 
  151.  
  152. Support -
  153. ---------
  154.  
  155.     I have established a sysop conference on my board to help those using the 
  156. programs that I have written.  All are welcome there whether you are using my 
  157. programs or not.  A Donation of $10 would be appreciated if you find this 
  158. program useful.  Please fill out the Sysop questionaire for access to the 
  159. conference.  As time permits, I will be coming out with other programs 
  160. that will be helpful to the RBBS sysops.  One of my goals now is to write 
  161. programs that will help automate the routine maintanence of the board and free 
  162. the sysop to pursue other parts of using RBBS or just to have some free time 
  163. away from the board.  The most recent versions of my programs will be 
  164. available on my board (Bluegrass RBBS (606)-272-0499), on the IBMCOM forum on 
  165. Compuserve, RBBS Chicago, Ken Goosen's board and from Public Brand Software, 
  166. Indianapolis Indiana (1-800-426-DISK).
  167.  
  168.     For those of you who would like copies of my programs but are not able to 
  169. find copies of them on the BBS's you use or dont want to spend a couple of 
  170. hours downloading them, I have come up with what I hope is an agreeable 
  171. solution.  For $10 (U.S.), I will send you 2 diskettes which will contain the 
  172. most recent versions of the programs mentioned here and any new ones written 
  173. since that time.  You can then decide which can help you the most and decide 
  174. which, if any, that you would like to register.  The $10 covers the cost of 
  175. the diskettes, shipping and my time in copying the programs from my hard drive 
  176. to floppy disk.  The programs will be sent to you on 5 1/4 diskettes.
  177.  
  178.  
  179. Other programs for RBBS sysops -
  180. --------------------------------
  181.  
  182. I have written the following programs that also follow the joblog spec -
  183.  
  184. FMSDIR  - checks for a matching file to the entry in the master directory
  185. FMSDUP  - checks for a duplicate of a file on more than one drive and sub-
  186.           directory combination
  187. JOBLOG  - helps those programs that I have not written or that do not follow
  188.           the job log spec to make an entry into the joblog file so that you 
  189.           know when they ran and how long they took.
  190. CALPRN  - automatically prunes the Callers file on RBBS to a specified number 
  191.           of Days while retaining the extracted information to a named file for
  192.           later use or analysis.
  193. SKED &  - an automatic maintanence scheduling program that helps automate most
  194. ROBOT     if not all the maintanence required on an RBBS board now.  Designed 
  195.           run as part of the nightly maintanence time as specified in the RBBS
  196.           .DEF file. 
  197. NEWFILE - builds a list of files (name & description) that were uploaded in 
  198.           the prior or current month.  The list can be for that month only or 
  199.           can be up to the current day.  This program can be used to generate
  200.           a bulletin of new files or can create a file suitable for use in a 
  201.           desktop publishing program.
  202. FMSCK   - basically duplicates the FMS file verifying functions found in the 
  203.           CONFIG.EXE program for RBBS-PC with a few enhancements.  A detailed 
  204.           list of the errors found in the FMS file is generated.  This program
  205.           can be run as part of the nightly maintanence procedure to check 
  206.           your master directory every couple of days when used with SKED.  If
  207.           no errors are found, a backup copy of the FMS directory can be 
  208.           written to a safe place on the system.
  209. LOGMGR  - designed to be run on the first of the month as a housecleaning
  210.           function to free up as much drive space as possible.  This keeps the
  211.           JOBLOG file pruned to the start of the current month.  The 
  212.           splintered files from CALPRN are also collected for placement into
  213.           the archive that is created by LOGMGR.  You also have the option to
  214.           put up to 3 other files into the archive by either adding or moving
  215.           them into the arhive.
  216. DIRMAKE - helps free you from having to change your dir.dir, dirg.dir & 
  217.           upcat.hlp files every time that you add, change or delete a category
  218.           or your board.  Extensive customizing is provided for in the program 
  219.           including 3 different options for creating the dir*.dir screens.
  220.  
  221. Other programs that I have written to help with the maintanence of RBBS -
  222.  
  223. FMSED   - helps with the maintanence of the Master Directory file
  224. QWRITE  - writes the questionaires used in the Askuser function of RBBS (You
  225.           put in the text and QWRITE writes the logic!)
  226.  
  227. This little gem is for you to give to your users -
  228.  
  229. FMSVIEW - lets users browse your master.dir file as though they were online  
  230.  
  231. Ronald Nutter
  232. Bluegrass RBBS      (606)-272-0499
  233. 1132 Mt. Rushmore Way
  234. Lexington,Ky  40502-5459
  235.  
  236.